Get License Info for Service

This request retrieves the details of the applied license factors for a specific service.

URI

Copy 
{{baseUrl}}/api/v3/customer/{customerGuid}/licenseinfo

HTTP Method

GET

Request Parameters

Parameter

Type

Description

umpCustomerGuid

string($uuid)

Id value created in the Live Platformcustomer tenant SQL database directory:

■ Operator Connect: A new OC Essentials service is created when a license is applied to the lead using Create Customer from Lead Overview). If this field is null, a license has not yet been applied to the lead.
■ Direct Routing: A new Hosted Essentials service is created by Create Essentials Customer.

This value is also obtained in the 'Get Task' response when the customer is created.

Example Response

Copy 
[
    {
        "acquiredLicenses": 50,
        "totalMonitoredUsers": 20,
        "currentlyLicensed": 24,
        "managedUsersDirectRouting": 6,
        "managedUsersOperatorConnect": 2,
        "managedUsersByLifeCycleManagement": 4,
        "managedUsersUserInterface": 10,
        "managedServiceNumbers": 2,
        "lastUpdate": "2023-11-06T16:05:06.0202209+00:00",
        "umpCustomerGuid": "b11a3f8a-9220-457a-938f-cae531f79d67",
        "licenseSettingsFlagsLevel": 2,
        "LicenseFactors": {
            "Managed Users - By Template": true,
            "Managed Users - By User Interface": true,
            "Managed Service Numbers": true
        }
    }
]

HTTP Responses

■ 200 OK

Parameter

Type

Description

acquiredLicenses

integer

Number of licenses configured during the Onboarding wizard process.

totalMonitoredUsers

string

Number of monitored M365 users.

currentlyLicensed

integer

Total number of currently licensed users.

managedUsersDirectRouting

integer

Total number of users configured and assigned with Direct Routing numbers. Voice Routing Policy 'Unrestricted' is applied to the number.

managedUsersOperatorConnect

integer

Total number of users configured and assigned with Operator Connect numbers (number is assigned in customer tenant Teams admin center). Assigned Uploaded number Assignments:

■ UserAssigned
■ ConferenceAssigned
■ VoiceApplicationAssigned
■ ThirdPartyAppAssigned

managedUsersByLifeCycleManagement

integer

Total number of users assigned to a LifeCycle Management template.

managedUsersUserInterface

integer

Total number of users with User properties updated using this interface.

lastUpdate

string ($date-time)

Timestamp of the last update to user license.

UmpCustomerGuid

string($uuid)

Id value created in the Live Platformcustomer tenant SQL database directory:

■ Operator Connect: A new OC Essentials service is created when a license is applied to the lead using Create Customer from Lead Overview). If this field is null, a license has not yet been applied to the lead.
■ Direct Routing: A new Hosted Essentials service is created by Create Essentials Customer.

This value is also obtained in the 'Get Task' response when the customer is created.

licenseSettingsFlagsLevel

integer

Indicates when one of the License Factors shown below has been updated by Global admin.

LicenseFactors

boolean

License factors that can be configured globally by Service Provider or overridden by the service configuration. One of the following:

■ Managed Users - By LifeCycle Management
■ Managed Users - By User Interface
■ Managed Service Numbers

See Managing User Licenses for details.

For more information, see Managing User Licenses and Configuring Direct Routing Service License Settings.